home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / win_utl1 / docvu12.zip / INTEGR.TXT < prev    next >
Text File  |  1996-01-16  |  6KB  |  122 lines
  1. Specifications for DocView Integration with external databases.
  2.  
  3. The following setup is required to integrate the external database with DocView:
  4.  
  5. A SETUP.SSU file located in the DocView's directory (the directory that holds 
  6. the docview.exe file) must hold the following pieces of data, each placed on a 
  7. separate line.  The line sequence is significant; if optional data is not 
  8. specified, the line must be left blank.
  9.  
  10. If the SETUP.SSU is missing or incomplete, certain menu  items and toolbar 
  11. buttons are removed from the screen.  Without the SETUP.SSU file, the DocView 
  12. program becomes a basic document viewer.
  13.  
  14. Images can be viewed via the DocView program by a DOCVIEW.EXE FILENAME.XXX command 
  15. (where FILENAME.XXX is the path name of the image file.  DocView can also 
  16. be launched from many Windows applications, such as internet browsers.
  17.  
  18. Example of a SETUP.SSU file (for MSACCESS 2.0  DATABASE)
  19.  
  20. C:\ACCESS\MSACCESS.EXE C:\DBDIR\MYDB.MDB
  21. Microsoft Access
  22. %(FU)DVMACRO1{ENTER}
  23. C:\ACCESS\MSACCESS.EXE C:\DBDIR\MYDB.MDB
  24. Microsoft Access
  25. %(FU)VDMACRO2{ENTER}
  26. D:\DOCS
  27. 7200
  28. 6000
  29.  
  30. The characters are not case sensitive, except possibly line 3 and line 6.
  31.  
  32. Lines 1-3 contain information about the external database's EDITING subsystem:
  33.      Line1 is the path/file name of the external database application.
  34.            If you don not integrate, enter 'None'.
  35.      Line2 is the precise name of the external database application as 
  36.           shown in its title bar.  If you don not integrate, enter 'None'.
  37.      Line3 represents the 'SendKeys' string for activating the external 
  38.           database application (more information below).
  39.  
  40. Lines 4-6 contain information about the external database's QUERY subsystem:
  41.      Line4 is the path/file name of the external database application.
  42.           If you don not integrate, enter 'None'.
  43.      Line5 is the precise name of the external database application as 
  44.           shown in its title bar.  If you don not integrate, enter 'None'.
  45.      Line6 represents the 'SendKeys' string for activating the external 
  46.           database application (more information below).
  47.  
  48. Line7 (optional) specifies the fixed path name of the directory that holds 
  49.      the image files. This is required only if the image address in the 
  50.      database does not include the directory name.
  51.  
  52. Line 8 is the width of the image display window in twips 
  53.      (1440 twips = 1 inch; 576 twips = 1 cm).
  54. Line 8 is the height of the image display window in twips 
  55.      (1440 twips = 1 inch; 576 twips = 1 cm).
  56.  
  57. Lines 1 and 2 and lines 4 and 5 may (but need not necessarily) be identical.
  58.  
  59.  
  60. In the external database application, you must create a script/macro that copies 
  61. the following data to the Windows clipboard, activates DocView and send 
  62. the F12 keystroke to DocView.
  63.  
  64. #F#xxxxxxxx.xxx,tttttttttt
  65. xxxxxxxx.xxx,tttttttttt
  66. xxxxxxxx.xxx,tttttttttt
  67.  
  68. Where #F# is a fixed starter tag,
  69. xxxxxxxxxx.xxx is the file name of the image.  
  70.     The directory path must be included unless it is declared 
  71.     in the third line of the SETUP.SSU file (see above).  
  72. tttttttttt is the optional description of the file that will be used in the 
  73.     image displays title bar.  If the tttttttttt is blank, the system 
  74.     uses the file name as a description.  If the tttttttttt is not used, 
  75.     the comma can be omitted.   
  76.  
  77. Normally, you will only have one line, one file. If you specify multiple lines, 
  78. the DocView program can display all the listed images in sequence by pressing 
  79. a 'Next' button.
  80.  
  81. As an example, a macro in Access 2.0 that sends the following keysstrokes 
  82. (SendKeys) will activates DocView:
  83. ^({ESC})<{Enter}{F12}
  84.     
  85.     
  86. When the DocView user requests the external application's EDIT Form,  DocView 
  87. copies a #E#xxxxxxxx.xxx string to the Windows clipboard, starts up or activates 
  88. the external application specified in lines 1 and 2 and send the keystrokes 
  89. specified in line 3 of The SETUP.SSU file to the external edit application. The 
  90. xxxxxxxx.xxx parameter represents the path/file name of the currently active 
  91. image in DocView.  If line 7 of the SETUP.SSU specifies a global directory path, 
  92. the matching path is removed from the parameter.  The #E# is an identifier flag.  
  93. The SendKeys keystrokes would normally include the commands for executing a 
  94. macro in the external database application that will pick up the image file name 
  95. in the Windows Clipboard and process it.
  96.  
  97. When the DocView user requests the external application's QUERY Form,  DocView 
  98. copies a #Q#xxxxxxxx.xxx string to the Windows clipboard, starts up or activates 
  99. the external application specified in lines 4 and 5 and send the keystrokes 
  100. specified in line 6 of The SETUP.SSU file to the external edit application. The 
  101. xxxxxxxx.xxx parameter represents the path/file name of the currently active 
  102. image in DocView.  If line 7 of the SETUP.SSU specifies a global directory path, 
  103. the matching path is removed from the parameter.  The #E# is an identifier flag.  
  104. The SendKeys keystrokes would normally include the commands for executing a 
  105. macro in the external database application that will pick up the image file name 
  106. in the Windows Clipboard and process it.
  107.  
  108.  
  109. SendKeys
  110.  
  111. In the example above, the %(FU)VDMACRO1{ENTER} has the following meaning:
  112. After opening the external application, the system sends the F and U keystrokes, 
  113. both while pressing the Alt key (as symbolized by the percent sign).  The F open 
  114. the File menu and the U opens the Macro Request.  The letters V D M A C R O 1  are 
  115. sent followed by the Enter key.  VDMACRO1 is the assumed macro name (it can of course  
  116. be any name). For more details on the SendKeys syntax, please consult the application's 
  117. documentation, or contact Informatik Inc.
  118.  
  119.  
  120. For support,  contact Informatik Inc. at 610.640.0339 or support@informatik.com.
  121.  
  122.